home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 June / SGI Freeware 1998 June.iso / dist / fw_fileutils.idb / usr / freeware / catman / u_man / cat1 / ls.Z / ls
Text File  |  1998-05-21  |  15KB  |  398 lines
  1. /xlv1/freeware/1998.May/fileutils/3.16/fileutils-3.16.diffbuild/man
  2.  
  3.  
  4.  
  5.      LLLLSSSS((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         LLLLSSSS((((1111))))
  6.  
  7.  
  8.  
  9.      NNNNAAAAMMMMEEEE
  10.       ls, dir, vdir    - list contents    of directories
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       llllssss [-abcdfgiklmnpqrstuxABCFGLNQRSUX1]    [-w cols] [-T cols]
  14.       [-I pattern] [--all] [--escape] [--directory]    [--inode]
  15.       [--kilobytes]    [--numeric-uid-gid] [--no-group] [--hide-
  16.       control-chars] [--reverse] [--size] [--width=cols]
  17.       [--tabsize=cols] [--almost-all] [--ignore-backups]
  18.       [--classify] [--file-type] [--full-time] [--ignore=pattern]
  19.       [--dereference] [--literal] [--quote-name] [--recursive]
  20.       [--sort={none,time,size,extension}]
  21.       [--format={long,verbose,commas,across,vertical,single-
  22.       column}] [--time={atime,access,use,ctime,status}] [--help]
  23.       [--version] [--color[={yes,no,tty}]]
  24.       [--colour[={yes,no,tty}]] [name...]
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.       This documentation is    no longer being    maintained and may be
  28.       inaccurate or    incomplete.  The Texinfo documentation is now
  29.       the authoritative source.
  30.  
  31.       This manual page documents the GNU version of    llllssss.  ddddiiiirrrr and
  32.       vvvvddddiiiirrrr are versions of llllssss with different default output
  33.       formats.  These programs list    each given file    or directory
  34.       name.     Directory contents are    sorted alphabetically.    For
  35.       llllssss, files are    by default listed in columns, sorted
  36.       vertically, if the standard output is    a terminal; otherwise
  37.       they are listed one per line.     For ddddiiiirrrr, files    are by default
  38.       listed in columns, sorted vertically.     For vvvvddddiiiirrrr, files are
  39.       by default listed in long format.
  40.  
  41.     OOOOPPPPTTTTIIIIOOOONNNNSSSS
  42.       -_a, --_a_l_l
  43.            List all    files in directories, including    all files that
  44.            start with `.'.
  45.  
  46.       -_b, --_e_s_c_a_p_e
  47.            Quote nongraphic    characters in file names using
  48.            alphabetic and octal backslash sequences    like those
  49.            used in C.
  50.  
  51.       -_c, --_t_i_m_e=_c_t_i_m_e, --_t_i_m_e=_s_t_a_t_u_s
  52.            Sort directory contents according to the    files' status
  53.            change time instead of the modification time.  If the
  54.            long listing format is being used, print    the status
  55.            change time instead of the modification time.
  56.  
  57.       -_d, --_d_i_r_e_c_t_o_r_y
  58.            List directories    like other files, rather than listing
  59.            their contents.
  60.  
  61.  
  62.  
  63.  
  64.      Page 1                         (printed 5/18/98)
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      LLLLSSSS((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         LLLLSSSS((((1111))))
  72.  
  73.  
  74.  
  75.       -_f   Do not sort directory contents; list them in whatever
  76.            order they are stored on    the disk.  The same as
  77.            enabling    -_a and -_U and disabling    -_l, -_s,    and -_t.
  78.  
  79.       --_f_u_l_l-_t_i_m_e
  80.            List times in full, rather than using the standard
  81.            abbreviation heuristics.
  82.  
  83.       -_g   Ignored;    for Unix compatibility.
  84.  
  85.       -_i, --_i_n_o_d_e
  86.            Print the index number of each file to the left of the
  87.            file name.
  88.  
  89.       -_k, --_k_i_l_o_b_y_t_e_s
  90.            If file sizes are being listed, print them in
  91.            kilobytes.  This    overrides the environment variable
  92.            POSIXLY_CORRECT.
  93.  
  94.       -_l, --_f_o_r_m_a_t=_l_o_n_g, --_f_o_r_m_a_t=_v_e_r_b_o_s_e
  95.            In addition to the name of each file, print the file
  96.            type, permissions, number of hard links,    owner name,
  97.            group name, size    in bytes, and timestamp    (the
  98.            modification time unless    other times are    selected).
  99.            For files with a    time that is more than 6 months    old or
  100.            more than 1 hour    into the future, the timestamp
  101.            contains    the year instead of the    time of    day.
  102.  
  103.       -_m, --_f_o_r_m_a_t=_c_o_m_m_a_s
  104.            List files horizontally,    with as    many as    will fit on
  105.            each line, separated by commas.
  106.  
  107.       -_n, --_n_u_m_e_r_i_c-_u_i_d-_g_i_d
  108.            List the    numeric    UID and    GID instead of the names.
  109.  
  110.       -_p   Append a    character to each file name indicating the
  111.            file type.
  112.  
  113.       -_q, --_h_i_d_e-_c_o_n_t_r_o_l-_c_h_a_r_s
  114.            Print question marks instead of nongraphic characters
  115.            in file names.
  116.  
  117.       -_r, --_r_e_v_e_r_s_e
  118.            Sort directory contents in reverse order.
  119.  
  120.       -_s, --_s_i_z_e
  121.            Print the size of each file in 1K blocks    to the left of
  122.            the file    name.  If the environment variable
  123.            POSIXLY_CORRECT is set, 512-byte    blocks are used
  124.            instead.
  125.  
  126.       -_t, --_s_o_r_t=_t_i_m_e
  127.  
  128.  
  129.  
  130.      Page 2                         (printed 5/18/98)
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      LLLLSSSS((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         LLLLSSSS((((1111))))
  138.  
  139.  
  140.  
  141.            Sort directory contents by timestamp instead of
  142.            alphabetically, with the    newest files listed first.
  143.  
  144.       -_u, --_t_i_m_e=_a_t_i_m_e, --_t_i_m_e=_a_c_c_e_s_s, --_t_i_m_e=_u_s_e
  145.            Sort directory contents according to the    files' last
  146.            access time instead of the modification time.  If the
  147.            long listing format is being used, print    the last
  148.            access time instead of the modification time.
  149.  
  150.       -_x, --_f_o_r_m_a_t=_a_c_r_o_s_s, --_f_o_r_m_a_t=_h_o_r_i_z_o_n_t_a_l
  151.            List the    files in columns, sorted horizontally.
  152.  
  153.       -_A, --_a_l_m_o_s_t-_a_l_l
  154.            List all    files in directories, except for `.' and `..'.
  155.  
  156.       -_B, --_i_g_n_o_r_e-_b_a_c_k_u_p_s
  157.            Do not list files that end with `~', unless they    are
  158.            given on    the command line.
  159.  
  160.       -_C, --_f_o_r_m_a_t=_v_e_r_t_i_c_a_l
  161.            List files in columns, sorted vertically.
  162.  
  163.       -_F, --_c_l_a_s_s_i_f_y
  164.            Append a    character to each file name indicating the
  165.            file type.  For regular files that are executable,
  166.            append a    `*'.  The file type indicators are `/' for
  167.            directories, `@'    for symbolic links, `|'    for FIFOs, `='
  168.            for sockets, and    nothing    for regular files.
  169.  
  170.       -_G, --_n_o-_g_r_o_u_p
  171.            Inhibit display of group    information in a long format
  172.            directory listing.
  173.  
  174.       -_L, --_d_e_r_e_f_e_r_e_n_c_e
  175.            List the    files linked to    by symbolic links instead of
  176.            listing the contents of the links.
  177.  
  178.       -_N, --_l_i_t_e_r_a_l
  179.            Do not quote file names.
  180.  
  181.       -_Q, --_q_u_o_t_e-_n_a_m_e
  182.            Enclose file names in double quotes and quote
  183.            nongraphic characters as    in C.
  184.  
  185.       -_R, --_r_e_c_u_r_s_i_v_e
  186.            List the    contents of all    directories recursively.
  187.  
  188.       -_S, --_s_o_r_t=_s_i_z_e
  189.            Sort directory contents by file size instead of
  190.            alphabetically, with the    largest    files listed first.
  191.  
  192.       -_U, --_s_o_r_t=_n_o_n_e
  193.  
  194.  
  195.  
  196.      Page 3                         (printed 5/18/98)
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      LLLLSSSS((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         LLLLSSSS((((1111))))
  204.  
  205.  
  206.  
  207.            Do not sort directory contents; list them in whatever
  208.            order they are stored on    the disk.  This    option is not
  209.            called -_f because the Unix llllssss -_f    option also enables -_a
  210.            and disables -_l,    -_s, and    -_t.  It    seems useless and ugly
  211.            to group    those unrelated    things together    in one option.
  212.            Since this option doesn't do that, it has a different
  213.            name.
  214.  
  215.       -_X, --_s_o_r_t=_e_x_t_e_n_s_i_o_n
  216.            Sort directory contents alphabetically by file
  217.            extension (characters after the last `.'); files    with
  218.            no extension are    sorted first.
  219.  
  220.       -_1, --_f_o_r_m_a_t=_s_i_n_g_l_e-_c_o_l_u_m_n
  221.            List one    file per line.
  222.  
  223.       -_w, --_w_i_d_t_h _c_o_l_s
  224.            Assume the screen is _c_o_l_s columns wide.    The default is
  225.            taken from the terminal driver if possible; otherwise
  226.            the environment variable    CCCCOOOOLLLLUUUUMMMMNNNNSSSS    is used    if it is set;
  227.            otherwise the default is    80.
  228.  
  229.       -_T, --_t_a_b_s_i_z_e    _c_o_l_s
  230.            Assume that each    tabstop    is _c_o_l_s    columns    wide.  The
  231.            default is 8.
  232.  
  233.       -_I, --_i_g_n_o_r_e _p_a_t_t_e_r_n
  234.            Do not list files whose names match the shell pattern
  235.            _p_a_t_t_e_r_n unless they are given on    the command line.  As
  236.            in the shell, an    initial    `.' in a filename does not
  237.            match a wildcard    at the start of    _p_a_t_t_e_r_n.
  238.  
  239.       --_c_o_l_o_r, --_c_o_l_o_u_r, --_c_o_l_o_r=_y_e_s, --_c_o_l_o_u_r=_y_e_s
  240.            Colorize    the names of files depending on    the type of
  241.            file.  See DDDDIIIISSSSPPPPLLLLAAAAYYYY CCCCOOOOLLLLOOOORRRRIIIIZZZZAAAATTTTIIIIOOOONNNN below.
  242.  
  243.       --_c_o_l_o_r=_t_t_y, --_c_o_l_o_u_r=_t_t_y
  244.            Same as --_c_o_l_o_r but only    if standard output is a
  245.            terminal.  This is very useful for shell    scripts    and
  246.            command aliases,    especially if your favorite pager does
  247.            not support color control codes.
  248.  
  249.       --_c_o_l_o_r=_n_o, --_c_o_l_o_u_r=_n_o
  250.            Disables    colorization.  This is the default.  Provided
  251.            to override a previous color option.
  252.  
  253.       --_h_e_l_p
  254.            Print a usage message on    standard output    and exit
  255.            successfully.
  256.  
  257.       --_v_e_r_s_i_o_n
  258.            Print version information on standard output then exit
  259.  
  260.  
  261.  
  262.      Page 4                         (printed 5/18/98)
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      LLLLSSSS((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         LLLLSSSS((((1111))))
  270.  
  271.  
  272.  
  273.            successfully.
  274.  
  275.     DDDDIIIISSSSPPPPLLLLAAAAYYYY    CCCCOOOOLLLLOOOORRRRIIIIZZZZAAAATTTTIIIIOOOONNNN
  276.       When using the --_c_o_l_o_r option, this version of llllssss will
  277.       colorize the file names printed according to the name    and
  278.       type of file.     By default, this colorization is by type
  279.       only,    and the    codes used are ISO 6429    (ANSI) compliant.
  280.  
  281.       You can override the default colors by defining the
  282.       environment variable LLLLSSSS____CCCCOOOOLLLLOOOORRRRSSSS (or LLLLSSSS____CCCCOOOOLLLLOOOOUUUURRRRSSSS).  The format
  283.       of this variable is reminicent of the    termcap(5) file
  284.       format; a colon-separated list of expressions    of the form
  285.       "xx=string", where "xx" is a two-character variable name.
  286.       The variables    with their associated defaults are:
  287.  
  288.         nnnnoooo         0         Normal (non-filename) text
  289.         ffffiiii         0         Regular file
  290.         ddddiiii         32         Directory
  291.         llllnnnn         36         Symbolic link
  292.         ppppiiii         31         Named pipe    (FIFO)
  293.         ssssoooo         33         Socket
  294.         bbbbdddd         44;37   Block device
  295.         ccccdddd         44;37   Character device
  296.         eeeexxxx         35         Executable    file
  297.         mmmmiiii         (none)  Missing file (defaults to fi)
  298.         oooorrrr         (none)  Orphanned symbolic    link (defaults to ln)
  299.         llllcccc         \e[    Left code
  300.         rrrrcccc         m         Right code
  301.         eeeecccc         (none)  End code (replaces    lc+no+rc)
  302.  
  303.       You only need    to include the variables you want to change
  304.       from the default.
  305.  
  306.       File names can also be colorized based on filename
  307.       extension.  This is specified    in the LS_COLORS variable
  308.       using    the syntax "*ext=string".  For example,    using ISO 6429
  309.       codes, to color all C-language source    files blue you would
  310.       specify "*.c=34".  This would    color all files    ending in .c
  311.       in blue (34) color.
  312.  
  313.       Control characters can be written either in C-style \-
  314.       escaped notation, or in ssssttttttttyyyy-like ^-notation.     The C-style
  315.       notation adds    \e for Escape, \_ for a    normal space characer,
  316.       and \? for Delete.  In addition, the \ escape    character can
  317.       be used to override the default interpretation of \, ^, :
  318.       and =.
  319.  
  320.       Each file will be written as <lc> <color code> <rc>
  321.       <filename> <ec>.  If the <ec>    code is    undefined, the
  322.       sequence <lc>    <no> <rc> will be used instead.     This is
  323.       generally more convenient to use, but    less general.  The
  324.       left,    right and end codes are    provided so you    don't have to
  325.  
  326.  
  327.  
  328.      Page 5                         (printed 5/18/98)
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      LLLLSSSS((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         LLLLSSSS((((1111))))
  336.  
  337.  
  338.  
  339.       type common parts over and over again    and to support weird
  340.       terminals; you will generally    not need to change them    at all
  341.       unless your terminal does not    use ISO    6429 color sequences
  342.       but a    different system.
  343.  
  344.       If your terminal does    use ISO    6429 color codes, you can
  345.       compose the type codes (i.e. all except the llllcccc, rrrrcccc, and eeeecccc
  346.       codes) from numerical    commands separated by semicolons.  The
  347.       most common commands are:
  348.  
  349.          0       to restore default color
  350.          1       for brighter    colors
  351.          4       for underlined text
  352.          5       for flashing    text
  353.         30       for black foreground
  354.         31       for red foreground
  355.         32       for green foreground
  356.         33       for yellow (or brown) foreground
  357.         34       for blue foreground
  358.         35       for purple foreground
  359.         36       for cyan foreground
  360.         37       for white (or gray) foreground
  361.         40       for black background
  362.         41       for red background
  363.         42       for green background
  364.         43       for yellow (or brown) background
  365.         44       for blue background
  366.         45       for purple background
  367.         46       for cyan background
  368.         47       for white (or gray) background
  369.  
  370.       Not all commands will    work on    all systems or display
  371.       devices.
  372.  
  373.       A few    terminal programs do not recognize the default end
  374.       code properly.  If all text gets colorized after you do a
  375.       directory listing, try changing the nnnnoooo and ffffiiii    codes from 0
  376.       to the numerical codes for your standard fore- and
  377.       background colors.
  378.  
  379.      BBBBUUUUGGGGSSSS
  380.       On BSD systems, the -_s option    reports    sizes that are half
  381.       the correct values for files that are    NFS-mounted from HP-UX
  382.       systems.  On HP-UX systems, it reports sizes that are    twice
  383.       the correct values for files that are    NFS-mounted from BSD
  384.       systems.  This is due    to a flaw in HP-UX; it also affects
  385.       the HP-UX llllssss program.
  386.  
  387.       If there was a single    standard for the English language it
  388.       would    not be necessary to support redundant spellings.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.      Page 6                         (printed 5/18/98)
  395.  
  396.  
  397.  
  398.